package cn.iocoder.yudao.module.iot.service.operationhistory;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.iot.controller.admin.operationhistory.vo.OperationHistoryPageReqVO;
import cn.iocoder.yudao.module.iot.controller.admin.operationhistory.vo.OperationHistorySaveReqVO;
import cn.iocoder.yudao.module.iot.dal.dataobject.operationhistory.OperationHistoryDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 操作历史记录 Service 接口
 *
 * @author 云智节
 */
public interface OperationHistoryService {

    /**
     * 创建操作历史记录
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createOperationHistory(@Valid OperationHistorySaveReqVO createReqVO);

    /**
     * 更新操作历史记录
     *
     * @param updateReqVO 更新信息
     */
    void updateOperationHistory(@Valid OperationHistorySaveReqVO updateReqVO);

    /**
     * 删除操作历史记录
     *
     * @param id 编号
     */
    void deleteOperationHistory(Long id);

    /**
    * 批量删除操作历史记录
    *
    * @param ids 编号
    */
    void deleteOperationHistoryListByIds(List<Long> ids);

    /**
     * 获得操作历史记录
     *
     * @param id 编号
     * @return 操作历史记录
     */
    OperationHistoryDO getOperationHistory(Long id);

    /**
     * 获得操作历史记录分页 (Admin端)
     *
     * @param pageReqVO 分页查询
     * @return 操作历史记录分页
     */
    PageResult<OperationHistoryDO> getOperationHistoryPage(OperationHistoryPageReqVO pageReqVO);

    /**
     * 获得操作历史记录分页 (App端)
     *
     * @param pageReqVO 分页查询
     * @param userId 用户ID
     * @return 操作历史记录分页
     */
    PageResult<OperationHistoryDO> getOperationHistoryPage(OperationHistoryPageReqVO pageReqVO, Long userId);

}